home *** CD-ROM | disk | FTP | other *** search
/ MacWorld 1999 February / Macworld (1999-02).dmg / Serious Demos / XTension demo / XTension manual 2.0 / XTension manual 2.0.rsrc / TEXT_153.txt < prev    next >
Text File  |  1998-07-18  |  2KB  |  54 lines
  1.  
  2. Verbs which get information about a unit or group :
  3.  
  4.  
  5. time delta:  Returns number of seconds since the named unit  changed state
  6.  time delta of  string  -- unit name
  7.     Result:   integer  -- in seconds
  8.     example :  if time delta of "Garage Motion" is greater  than 3 * minutes then
  9.              turnoff "Garage Lights"
  10.                   end if
  11.  
  12. Every time XTension changes the value of a database item, it also changes the last time stamp for the unit.
  13. This verb will return the number of seconds since the named unit or group was last changed by XTension, whether from autonomous input or by a script.  IE:  time of last change to database for that unit/group.
  14.  
  15.  
  16. last timestamp: Get the last timestamp for a unit
  17.  last timestamp of  string  -- unit name
  18.     Result:   integer  -- timestamp in seconds
  19.     example :  display dialog "The door bell last rang at "  & ¬¨
  20.                             time string for last timestamp of "Door Bell"
  21.           
  22. This verb returns the value of the last timestamp for the given unit or group.  IE:  time of last change to database for that unit/group.
  23.  
  24.  
  25. status: Get the status of a unit
  26.  status of  string  -- unit name
  27.     Result:   'unen'  -- unit status
  28.     example :  if status of "Garage Motion" is true then
  29.             turnon "Outside Siren"
  30.             end if
  31.  
  32. This verb provides the basic function of getting the current status of any unit or group in the database.
  33. The result is a value which can be tested for true/false.  False = 0  ,  True  ‚↠0
  34.  
  35.  
  36. value: Get the analog value of a unit
  37.  value of  string  -- unit name
  38.     Result:   small integer
  39.  example :  if value of "Temperature" is greater than 70  then
  40.              turnoff "Heating"
  41.              end if
  42.  
  43. This verb returns the analog value of a unit.  If the unit is 'dimmable', then this value can be set via the 'DIM' verb, or through the control panel.  The value can range from 0 to 100.
  44.  
  45.  
  46. query: Send a status request to a unit and receive status response
  47.  query of  string
  48.     Result:   small integer
  49.  example :  if query of "Driveway Motion" is true then
  50.              write log "Someone is moving at the front  driveway sensor"
  51.              end if
  52.  
  53. This verb provides a method of issuing the X-10 standrd 'status request' to devices which respond to such commands.  Recent devices have been developed which will respond to this command with the current value of the unit's state.  At the current time, only discrete values are returned from any unit which honors this X-10 command.  This means only True/False can be tested.
  54.